From c4018b02218f36b4e43cce86f89951eb1826433f Mon Sep 17 00:00:00 2001 From: BST 2000 Tony Gale Date: Thu, 22 Jun 2000 12:43:24 +0000 Subject: [PATCH] Add Section 2 Thu Jun 22 13:41:09 BST 2000 Tony Gale * docs/gtk-faq.sgm: Add Section 2 --- ChangeLog | 4 + ChangeLog.pre-2-0 | 4 + ChangeLog.pre-2-10 | 4 + ChangeLog.pre-2-2 | 4 + ChangeLog.pre-2-4 | 4 + ChangeLog.pre-2-6 | 4 + ChangeLog.pre-2-8 | 4 + docs/gtk-faq.sgm | 251 ++++++++++++++++++++++++++++++++++++++++++--- 8 files changed, 266 insertions(+), 13 deletions(-) diff --git a/ChangeLog b/ChangeLog index b08205a14e..1156d2ee39 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +Thu Jun 22 13:41:09 BST 2000 Tony Gale + + * docs/gtk-faq.sgm: Add Section 2 + Thu Jun 22 08:43:45 BST 2000 Tony Gale * docs/gtk-faq.sgm: New file. Start of DocBook diff --git a/ChangeLog.pre-2-0 b/ChangeLog.pre-2-0 index b08205a14e..1156d2ee39 100644 --- a/ChangeLog.pre-2-0 +++ b/ChangeLog.pre-2-0 @@ -1,3 +1,7 @@ +Thu Jun 22 13:41:09 BST 2000 Tony Gale + + * docs/gtk-faq.sgm: Add Section 2 + Thu Jun 22 08:43:45 BST 2000 Tony Gale * docs/gtk-faq.sgm: New file. Start of DocBook diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index b08205a14e..1156d2ee39 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,3 +1,7 @@ +Thu Jun 22 13:41:09 BST 2000 Tony Gale + + * docs/gtk-faq.sgm: Add Section 2 + Thu Jun 22 08:43:45 BST 2000 Tony Gale * docs/gtk-faq.sgm: New file. Start of DocBook diff --git a/ChangeLog.pre-2-2 b/ChangeLog.pre-2-2 index b08205a14e..1156d2ee39 100644 --- a/ChangeLog.pre-2-2 +++ b/ChangeLog.pre-2-2 @@ -1,3 +1,7 @@ +Thu Jun 22 13:41:09 BST 2000 Tony Gale + + * docs/gtk-faq.sgm: Add Section 2 + Thu Jun 22 08:43:45 BST 2000 Tony Gale * docs/gtk-faq.sgm: New file. Start of DocBook diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4 index b08205a14e..1156d2ee39 100644 --- a/ChangeLog.pre-2-4 +++ b/ChangeLog.pre-2-4 @@ -1,3 +1,7 @@ +Thu Jun 22 13:41:09 BST 2000 Tony Gale + + * docs/gtk-faq.sgm: Add Section 2 + Thu Jun 22 08:43:45 BST 2000 Tony Gale * docs/gtk-faq.sgm: New file. Start of DocBook diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6 index b08205a14e..1156d2ee39 100644 --- a/ChangeLog.pre-2-6 +++ b/ChangeLog.pre-2-6 @@ -1,3 +1,7 @@ +Thu Jun 22 13:41:09 BST 2000 Tony Gale + + * docs/gtk-faq.sgm: Add Section 2 + Thu Jun 22 08:43:45 BST 2000 Tony Gale * docs/gtk-faq.sgm: New file. Start of DocBook diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index b08205a14e..1156d2ee39 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,3 +1,7 @@ +Thu Jun 22 13:41:09 BST 2000 Tony Gale + + * docs/gtk-faq.sgm: Add Section 2 + Thu Jun 22 08:43:45 BST 2000 Tony Gale * docs/gtk-faq.sgm: New file. Start of DocBook diff --git a/docs/gtk-faq.sgm b/docs/gtk-faq.sgm index aa742351fb..352cbc8647 100644 --- a/docs/gtk-faq.sgm +++ b/docs/gtk-faq.sgm @@ -27,13 +27,16 @@ - + General Information Here's a paragraph of text because it is stylistically poor to start a section right after the chapter title. + + + Before anything else: the greetings The FAQ authors want to thank: @@ -265,8 +268,43 @@ What applications have been written with GTK+? - - + A list of some GTK+ based application can be found on + the GTK+ web server at http://www.gtk.org/apps/ + and contains more than 350 applications. + Failing that, look for a project to work on for the + GNOME project, http://www.gnome.org/ + Write a game. Write something that is useful. + Some of these are: + + + GIMP (http://www.gimp.org/), an + image manipulation program + + AbiWord (http://www.abisource.com/), + a professional word processor + + Gzilla (http://www.levien.com/gzilla/), + a web browser + + XQF (http://www.botik.ru/~roma/quake/), + a QuakeWorld/Quake2 server browser and launcher + + GDK Imlib (http://www.rasterman.com/imlib.html), + a fast image loading and manipulation library for GDK + + Glade (http://glade.pn.org/), a + GTK+ based RAD tool which produces GTK+ applications + + + @@ -287,20 +325,207 @@ + + + + + + How to find, configure, install, and troubleshoot GTK+ + + + + + + + What do I need to run GTK+? + To compile GTK+, all you need is a C compiler (gcc) and + the X Window System and associated libraries on your system. + + + + + + Where can I get GTK+? + The canonical site is ftp://ftp.gtk.org/pub/gtk. + This site tends to get busy around the time of a new + GTK+ release so try and use one of the mirror sites that are + listed in ftp://ftp.gtk.org/etc/mirrors + Here's a few mirror sites to get you started: + + + Africa - ftp://ftp.is.co.za/applications/gimp/ + + Australia - ftp://ftp.au.gimp.org/pub/gimp/ + + Finland - ftp://ftp.funet.fi/pub/sci/graphics/packages/gimp + + Germany - ftp://infosoc.uni-koeln.de/pub/ftp.gimp.org/ + + Japan - ftp://SunSITE.sut.ac.jp/pub/archives/packages/gimp/ + + UK - ftp://ftp.flirble.org/pub/X/gimp/ + + US - ftp://ftp.insync.net/pub/mirrors/ftp.gimp.org/ + + + + + + + + How do I configure/compile GTK+? + Generally, all you will need to do is issue the commands: + + ./configure + make + + in the gtk+-version/ directory. + + + + + + When compiling GTK+ I get an error like: <literal>make: + file `Makefile' line 456: Syntax error</literal> + Make sure that you are using GNU make (use make + -v + to check). There are many weird and wonderful versions of make + out there, and not all of them handle the automatically + generated Makefiles. + + + + + + I've compiled and installed GTK+, but I can't get any + programs to link with it! + This problem is most often encountered when the GTK+ + libraries can't be found or are the wrong version. Generally, + the compiler will complain about an 'unresolved symbol'. + There are two things you need to check: + + + Make sure that the libraries can be + found. You want to edit /etc/ld.so.conf to + include the directories which contain the GTK libraries, + so it looks something like: + /usr/X11R6/lib + /usr/local/lib + + Then you need to run /sbin/ldconfig as root. You can + find what directory GTK is in using + + gtk-config --libs + + + If your system doesn't use ld.so to find libraries +(such as Solaris), then you will have to use the LD_LIBRARY_PATH +environment variable (or compile the path into your program, which I'm +not going to cover here). So, with a Bourne type shell you can do (if +your GTK libraries are in /usr/local/lib): + + export LD_LIBRARY_PATH=/usr/local/lib + + and in a csh, you can do: + + setenv LD_LIBRARY_PATH /usr/local/lib + + + Make sure the linker is finding the +correct set of libraries. If you have a Linux distribution that +installs GTK+ (e.g. RedHat 5.0) then this older version may be +used. Now (assuming you have a RedHat system), issue the +command + + rpm -e gtk gtk-devel + + You may also want to remove the packages that depend +on gtk (rpm will tell you which ones they are). If you don't have a RedHat Linux system, check to make sure +that neither /usr/lib or /usr/local/lib contain any of +the libraries libgtk, libgdk, libglib, or libgck. If they do exist, remove them +(and any gtk include files, such as /usr/include/gtk and /usr/include/gdk) +and reinstall gtk+. + + + + + + + + When compiling programs with GTK+, I get compiler error + messages about not being able to find + <literal>glibconfig.h</literal>. + The header file "glibconfig.h" was moved to the + directory $exec_prefix/lib/glib/include/. $exec_prefix is the + directory that was specified by giving the --exec-prefix flags + to ./configure when compiling GTK+. It defaults to $prefix, + (specified with --prefix), which in turn defaults to /usr/local/. + + This was done because "glibconfig.h" includes + architecture dependent information, and the rest of the + include files are put in $prefix/include, which can be shared + between different architectures. + + GTK+ includes a shell script, /gtk-config/, that makes it + easy to find out the correct include paths. The GTK+ Tutorial + includes an example of using /gtk-config/ for simple + compilation from the command line. For information about more + complicated configuration, see the file docs/gtk-config.txt in + the GTK+ distribution. + + If you are trying to compile an old program, you may be + able to work around the problem by configuring it with a + command line like: + + setenv CPPFLAGS "-I/usr/local/include/glib/include" +./configure + + (Substitute the appropriate value of $exec_prefix for + /usr/local.) + + + + + + When installing a GTK+ application, configure reports + that it can't find GTK. + There are several common reasons for this: + + You have an old version of GTK installed + somewhere. RedHat 5.0, for example, installs an older copy of GTK that + may not work with the latest applications. You should remove this old + copy, but note that in the case of RedHat 5.0 this will + break the control-panel applications. + + gtk-config (or another + component of GTK) isn't in your path, or there is an old + version on your system. Type: + gtk-config --version + + to check for both of these. If it returns a value + different from what you expect, then you have an old + version of GTK on your system. + + The ./configure script can't find the GTK + libraries. As ./configure compiles various test programs, it needs to + be able to find the GTK libraries. See the question above + for help on this. + + + If none of the above help, then have a look in + config.log, which is generated by ./configure as it runs. At the + bottom will be the last action it took before failing. If it is a + section of source code, copy the source code to a file and compile it + with the line just above it in config.log. If the compilation is + successful, try executing it. + + - - Remaining details - Although this booklet is quite complete, here I will -mention some details I never got to. - - Use of the word dude - Here's an example of how to say -dude: DUDE. - - -- 2.30.2